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Summary 


Navigation and Ancillary Information Facility 


¢ NAIF makes available a set of applications not included in the 
Toolkits. This set includes programs for: 


making, modifying, validating, inspecting, and converting SPK files: 
» pinpoint, dafcat, bspidmod, dafmod, spy, oem2spk, spk20em 
making and modifying CK files 
» prediCkt, ckslicer, ckspanit, dafcat, cksmrg, dafmod 
making SCLK files 
» makclk 
merging and modifying DSK files 
» dlacat, dskmod 
computing derived quantities 
» orbnum, optics, spy 


determining SPICE kernel type and binary format, and converting between 
native and non-native formats 


» archtype, bff, bingo 


¢ Executables and User’s Guides are on the NAIF server at: 


https://naif.jpl.nasa.gov/naif/utilities.html 


Non-Toolkit Applications 


NAIE> Using Non-Toolkit Apps 
Navigation and Ancillary Information Facility 


¢ All of these apps are meant to be used as 
operating system shell executables 


— One generally cannot run these within IDL or MATLAB- 
run them from an operating system shell 
» In some cases you can run from within IDL or 
MATLAB, but this is not recommended: 
¢ In IDL, use the “spawn” command 
¢ In MATLAB, use the “system” command 
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PINPOINT 


Navigation and Ancillary Information Facility 


¢ pinpoint is a program for creating SPK files and topocentric 
frames FK files for objects for which the position is a constant 
offset with respect to another object 


— Ground stations 
— Landing sites, sites along a rover path 
— Relative positions of manipulator joints, etc. 


¢ pinpoint is a command line program with the following usage: 


pinpoint -def deffile -spk spkfile [-pck tkfile] [-fk fk] [flags] 


— “deffile” is an input definitions file following text kernel file format and 
containing a set of keywords defining ID, center, reference frame, position (as 
XYZ or Gaussian Lat/Lon/Alt) and time coverage boundaries, and optionally 
velocity and topocentric frame axes specifications, for one or more objects 


» The contents of “deffile” are included in the comment area 


— “spkfile” is an output SPK file containing a type 8 SPK segment for each of the 
objects specified in the “deffile” 


— “tkfile” is an optional input PCK file (needed if positions in the “deffile” are 
given as Lat/Lon/Alt) or FK file (needed if one or more of the frames specified 
in “deffile” is not one of the frames built into the Toolkit) 


— “fk” is an optional output topocentric frames FK file 
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PINPOINT Example 


Navigation and Ancillary Information Facility 


Terminal Window 


S more merl_ meridiani.def 


Sample PINPOINT input for MER-1 landing site coordinates. 


\begindata 
SITES 
LS_ CENTER 
LS FRAME 
LS _IDCODE 


= ( TEst ) 
= 499 

= 'TAU MARS' 
= -253900 


LS_XYZ 
LS BOUNDS 
\begintext 


S pinpoint -def 


Brief. Version: 


= ( +3.37604222E+03 -3.2664876E+02 -1.1539218E+02  ) 
= ( €2001=-01=01-00200700.000, €2100-01-01-=00700700.000) 


merl meridiani.def -spk merl_meridiani.bsp 


$ brief merl_meridiani.bsp 
22200 (SPICE Toolkit N0O057) 


Summary for: merl meridiani.bsp 
Body: —253900* wir.t. MARS (499) 
Start of Interval (ET) 
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DAFCAT 


Navigation and Ancillary Information Facility 


¢ dafcat is a program for concatenating binary DAF files by simply 
copying all data segments from all input files, in the order they are 
provided, into the output file 


— dafcat works on SPKs, CKs, and binary PCKs 


» It will not merge different types of kernels together, i.e. it will not merge 
SPKs with CKs, CKs with PCKs, etc. 


» For merging SPKs, in most cases spkmerge should be used instead 
because it provides a much more powerful and sophisticated capability 


¢ dafcat is a command line program with the following usage 
dafcat output file 
— “output_file” is the output file name and is the program’s only argument 
— Input file names are provided from standard input 
» this is very convenient for use with Unix shell pipes 


¢ dafcat does not put any information into the comment area of the 
a file, leaving this responsibility to the user (use commnt to do 
so 
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DAFCAT Example: SPK 


Navigation and Ancillary Information Facility 


Terminal Window 


$ dafcat m01_merged.bsp 
DAF binary files concatenation program version 1.00 


spk_m_0d33905-33993 rec vl.bsp 
spk_m_0d33992-34065 rec vl.bsp 
“D 
Concatenating files: 
spk .m Gd33905-33993 rec. wi. 
spk m od33992-340605 rec vi. 
to: 


mO1 merged.bsp 


$ ls -1 spk_m_od* rec vl.bsp | dafcat m01_ merged 2.bsp 


DAF binary files concatenation program version 1.00 


Concatenating files: 
Spk Mm o032371—-32450 rec vl.bsp 
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DAFCAT Example: CK 


Navigation and Ancillary Information Facility 


Terminal Window 
S dafcat m01.bc 


DAF binary files concatenation program version 1.00 


mO1_sc_2004-04-20.bc 

mO1_sc_2004-04-21.be 

4D 

Concatenating files: 
mO1 sc_2004-04-20.bce 
mO1l sc 2004-04-21 .be 

Coz 


mOl.bc 


S$ ls -1 m01_sc_2004-04-2*.be | dafcat m01.be 


DAF binary files concatenation program version 1.00 


Concatenating files: 
m01 sc_2004-04-20.bce 
mO1 sc_2004-04-21.bce 
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DLACAT 


Navigation and Ancillary Information Facility 


¢ dlacat is a program for concatenating binary DLA files by simply 
copying all data segments from all input files, in the order they are 
provided, into the output file 


— Works on DSKs 
¢ dlacat is a command line program with the following usage 


dlacat output file 
— “output_file” is the output file name and is the program’s only argument 
— Input file names are provided from standard input 

» this is very convenient for use with Unix shell pipes 


¢ dlacat does not put any information into the comment area of the 
output file, leaving this responsibility to the user (use commnt to do 
so) 
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DLACAT Example: DSK 


Navigation and Ancillary Information Facility 


Terminal Window 


$ dlacat phoebe shape.bds 


DLA binary files concatenation program version 1.00 


“D 
Concatenatin 
phoebe_sh 
phoebe sh 
to: 


phoebe_sh 


phoebe shape partl.bds 
phoebe shape part2.bds 


g files: 
ape partl.bds 
ape part2.bds 


ape.bds 


$ ls -1 phoebe shape part?.bds | dlacat phoebe shape 2.bds 


DLA binary files concatenation program version 1.00 


Concatenatin 
phoebe_sh 
phoebe sh 
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g files: 
ape partl.bds 
ape part2.bds 


BSPIDMOD 


Navigation and Ancillary Information Facility 


¢ bspidmod is a program for altering the object IDs in a binary SPK file 


— It can be used to modify IDs in an SPK file(s) produced with a “bogus” spacecraft ID (or a 
simulation spacecraft ID) 


— It can be used to replace “official” IDs with “bogus” IDs if two different trajectories for 
the same object need to be used in the same program at the same time (for example for 
comparison, such as is done by spkdiff) 


¢ bspidmod has the following usage: 
bspidmod -spki inpspk -idi inpid -ido outid -mod item -oflg 
— “inpspk” is the input SPK file; “inpid” and “outid” are the current ID and new ID 
— “item” indicates which IDs are to be replaced: 


* TARGET -- only target IDs are replaced, 
¢ CENTER -- only center IDs are replaced, or 
* OBJECT -- both target and center IDs are replaced 


» Replacements are made only when “inpid” matches an ID found in the input SPK 


— “.oflg” flag indicating that changes should be made directly in the input file; if not 
specified, the program produces an output file with name that has “_out” appended to 
the name of the input file 


» In order for changes to be made in the input file it must be in the native binary 
format; if it is not, bingo may be used to convert it to the native binary format 


— A note stating which IDs were modified is put in the comment area 
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BSPIDMOD Example 


Navigation and Ancillary Information Facility 


Terminal Window 


$ brief mer2_crus_ sim_id.bsp 
Brief. Version: 2.2.0 (SPICE Toolkit NO057) 


Summary for: mer2 crus sim id.bsp 


Body: -255 
Start of Interval 


2003 JUL 09 00:15:00.000 2004 JAN 04 04:25:42.557 


S bspidmod -spki mer2_crus_sim_id.bsp -idi -255 -ido -254 -mod target -oflg 


The file mer2 crus sim id.bsp has been updated. 


$ brief mer2_crus_ sim_id.bsp 
Brief. Version: 2.2.0 (SPICE Toolkit N0O057) 


Summary for: mer2 crus sim id.bsp 


Body: MER-2 (-254) 
Start of Interval 
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NAIE> DSKMOD 
Navigation and Ancillary Information Facility 


¢ dskmod alters selected segment attributes in a binary 
DSK file: 
— body, surface, or reference frame ID 
— data class ID 
— coordinate system bounds 
— coverage start and stop times 


¢ dskmod can modify attributes “in place” in the input 
DSK or can write output to a new DSK file 


¢ dskmod puts into the comment area a warning note 
stating which items in which segments of the file were 
changed 


¢ dskmod works with files in native binary format 
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DSKMOD Example 


Navigation and Ancillary Information Facility 


Terminal Window 
$ dskbrief phobos 2014 09 22.bds 


Summary for: phobos 2014 09 22.bds 
Body: 401 (PHOBOS) 
Surface: 401 (Name not available) 
$ dskmod -dskin phobos 2014 09 22.bds -mod SURFACE -from 401 -to 1001 -overwrite 


DSKMOD Program; Ver. 1.0, 16-NOV-2021; Toolkit Ver. N0Q067 


DSK input file: phobos 2014 09 22.bds. 
The descriptor field SURFACE has been changed from 401 to 1001 in DSK segment 1. 
The file phobos 2014 09 22.bds has been modified and saved as phobos 2014 09 22.bds. 


$ dskbrief phobos 2014 09 22.bds 


Summary for: phobos 2014 09 22.bds 


Body: 401 (PHOBOS) 
Surface: 1001 (Name not available) 
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DAFMOD 


Navigation and Ancillary Information Facility 


dafmod is a program for altering selected segment attributes in a binary 
SPK, CK, or PCK file 

— In an SPK file it can alter the target, center, or reference frame ID 

— InaCK or binary PCK file it can alter the object or reference frame ID 
dafmod is an interactive program. When executed it prompts the user for 

— name of the file to be modified 

— “item” to be modified 

» the set of items depends on the kernel type 

— “old” item value 

— “new” item value 
dafmod puts into the comment area a warning note stating which items 
in which segments of the file were changed 
dafmod works only on files in native binary format 


— bingo may be used to convert a non-native binary kernel to native binary format 
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DAFMOD Example: SPK 


Navigation and Ancillary Information Facility 


Terminal Window 


$ brief mer2_crus_ sim_id.bsp 


Summary for: 


Body: -255 


S dafmod 


File 
Item 


Old Value: 
New Value: 


mer2 crus sim id.bsp 


DAFMOD -- Version 2.0.0, January 30, 2008 -- Toolkit Version NO063 
banner providing usage instructions ...) 


: mer2 crus sim_id.bsp 


target 
-255 
-254 


The file mer2 crus sim id.bsp has been updated. 


S brief mer2_crus_sim_id.bsp 


Summary for: 


Body: MER-2 
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mer2 crus sim id.bsp 


(-254) 


DAFMOD Example: CK 


Navigation and Ancillary Information Facility 


Terminal Window 


S eckbrief -rel mro_sc_ pred.bc mro.tsc naif0009.tls 


Summary for: mro_sc_ pred.bc 


2009-AUG-15 23:31:02.347 2009-AUG-30 00:00:58.388 Y -74900 


S dafmod 


DAFMOD -- Version 2.0.0, January 30, 2008 -- Toolkit Version NO063 
banner providing usage instructions ...) 
File : mro_sc_pred.bc 
Item : frame 
Old Value: -74900 
New Value: 16 
The file mro sc pred.be has been updated. 


S eckbrief -rel mro_sc_pred.bc mro.tsc naif0009.tls 


summary for: mro se pred.be 


2009-AUG-15 23:31:02.347 2009-AUG-30 00:00:58.388 Y MARS TAU 
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SPY 


Navigation and Ancillary Information Facility 


¢ Spy is acommand line program for validating, inspecting, and 
analyzing SPK files 


¢ Spy can: 
— check SPK files 
» Validate SPK structure 
» Check sampled data for bounds violations 
» Locate invalid double precision numbers 
— sample data from a set of loaded kernels 


» Sample position, distance, velocity, derived velocity, speed, acceleration, 
acceleration magnitude, osculating elements 


— dump SPK file contents 

» Data 

» Summary information 

» Comment area 

» Bookkeeping information 
— find some geometric events 


» Distance: find times when specified constraints on observer-target distance 
are met 


» Elevation: find times when specified constraints on elevation of target in 
specified frame are met 
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SPY: Selected Features 


Navigation and Ancillary Information Facility 


¢ Operating modes 
— Interactive, batch, shell command line 
¢ Auxiliary files 
— Start-up file, command files, log file, save file 


¢ Interactive command support 


— Command history: recall, repetition, and command editing; editor selection; 
command error detection; (limited) automatic command error correction 


¢ User default support 
— Set, show, reset default values 
¢ Input options 
— Define user symbols in commands 
— Embed prompts in commands 
¢ Output options 
— Dump subsets of SPK data 
— Show epoch and packet deltas in data dumps 
— Set sample count or density 
— Set time and number formats 
— Set angular units 
— Set coordinate system for sampled data 
— Control error diagnostic verbosity 
¢ Online help: command language summary 
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SPY Example: Dump SPK Data 


Navigation and Ancillary Information Facility 


Terminal Windo 


Spy > dump data spk testspk.bsp segment index 13 stop packet 2; 


Dump of SPK File testspk.bsp 


Segment Summary: 


Segment ID : SPY test segment: type 18 subtype 0 
Target Body : Body 1800 
Center Body : Body 1899 
Reference Frame : Frame 17, ECLIPJ2000 
SPK Data Type : Type 18 

Description : Mex/Rosetta Hermite/Lagrange Interpolation 
UTC Start Time : 2000 JAN 01 11:59:05.816 
UTC Stop Time : 2000 JAN 01 12:32:15.816 
ET Start Time : 2000-JAN-01 12:00:10.000000 (TDB) 
ET Stop Time : 2000-JAN-01 12:33:20.000000 (TDB) 
DAF Begin Address: 35287 


DAF End Address 
Segment Parameters: 


Packet Count 
Directory Count 
Window Size - 1 
Polynomial Degree: 13 
Subtype : 0 
Description : Hermite interpolation, 12-element packets 


Time Tags and Packets: 


State Components: Position X, (km) 
Velocity X, (km/s) 
Velocity X, (km/s) 
Accel. x (km/s*2) 


2000-JAN-01 12:00:10.000000 (TDB) 1.00103333E+03 .00203333E+03 1.00303333E+03 -00403333E+03 .00503333E+03 
1.00603333E+03 


.00703333E+03 -00803333E+03 1.00903333E+03 -01003333E+03 -01103333E+03 


2.00703333E+03 2.00803333E+03 2.00903333E+03 2.01003333E+03 2.01103333E+03 
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SPY Example: Sample State Vectors 


Navigation and Ancillary Information Facility 


Terminal Window 


Spy > load naif0009.tls; 
Spy > load de421.bsp; 
Spy > sample states 
observer earth 
target moon 
start time 2008 oct 28 00:00:00.000000 
stop time 2008 oct 28 00:01:00.000000 
frame eclipJ2000 
aberration correction none 
coordinates latitudinal 
time format numeric E23.16 
number format F13.6 
step size 10.0; 


Sample STATE Results 


Target : moon 
Observer : earth 

Frame : eclipJ2000 
Aberration Correction: none 
Coordinate System : latitudinal 


240000000000E4 395800.315095 156.260092 - 660937 .035837 A 1 -000005 
240100000000E4 395800.673459 156.258644 - 660983 - 035836 : 1 -000005 
240200000000E4 395801.031820 156.257196 - 661028 -035836 . 1 -000005 
240300000000E4 395801.390177 156.255748 - 661074 -035836 : 1 -000005 
240400000000E4 395801.748532 156.254300 - 661120 035835 : dl -000005 
240500000000E4 395802.106883 156.252851 - 661165 -035835 : 1 -000005 
240600000000E4 395802.465231 156.251403 -661211 035835 F HE -000005 
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SPY Example: Check SPK Integrity 


Navigation and Ancillary Information Facility 


Terminal Window 


Spy > check integrity spk testspk.bsp; 


Structure Inspection of SPK File testspk.bsp 


Segment Number 11 


Segment Summary: 


Segment ID : SPY test segment: type 15 
Target Body : Body 1501 
Center Body : Body 1599 
Reference Fram : Frame 17, ECLIPJ2000 
SPK Data Type : Type 15 
Description : Two-Body with J2 Precession 
UTC Start Time : 2000 JAN 01 11:59:05.816 
UTC Stop Time : 2000 JAN 01 12:32:15.816 
I tart Time : 2000-JAN-01 12:00:10.000000 (TDB) 
top Time : 2000-JAN-01 12:33:20.000000 (TDB) 
Begin Address: 35259 
End Address : 35274 


Error: Invalid Unit Periapsis Pole Vector 


The periapsis pole vector should have unit length but in fact has length 4.58257569 


One error diagnostic and no warnings generated for SPK file testspk.bsp 
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OEM2SPK and SPK20O0EM 


Navigation and Ancillary Information Facility 


¢ oem2spk is a program for converting a CCSDS* “Orbit 
Ephemeris Message” (OEM) text file to a Type 9 or 13 
SPICE SPK file 


— It is a command line program using a setup file to specify conversion 
parameters 


— It can process OEM versions 1 and 2 
— It is primarily used for exchange of spacecraft trajectories between 
space agencies 
¢ spk2oem is a program for converting a Type 1, 9 or 13 
SPICE SPK to an OEM file 


— It is a command line program using a setup file to specify conversion 
parameters 


— It performs conversion in “data-driven” or “uniform sampling” mode 


¢ For more details see the oem2spk and spk20em user 
guides 


*CCSDS = Consultative Committee on Space Data Systems 
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PREDICKT 


Navigation and Ancillary Information Facility 


¢ prediCkt is a command line program for making CK 
files from a set of orientation specification rules, 


using schedules defining when these rules are to be 
applied 
— It requires orientation and schedule specification to be provided ina 
setup file that follows the SPICE text kernel syntax 


— It requires all supporting kernels -- SPK, PCK, etc -- to be loaded 
using a meta kernel 


— For more details see the “Making a CK Tutorial” 
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CKSLICER 


Navigation and Ancillary Information Facility 


¢ ckslicer is a command line program for subsetting a CK file 
¢ ckslicer has the following usage 


ckslicer -lsk <lsk_file name> 
-sclk <sclk_file name(s)> 
-inputck <ck_file name> 
-outputck <ck_ file name> 
-id <naif_id> 
-timetype <utc|sclk|ticks> 
-start <start_time> 
-stop <stop_time> 


¢ ckslicer is useful in the situation when only a portion of a CK 
covering a short interval of time is needed (for example when the 
whole CK is not needed and it takes up a lot of space) or to cut 
out parts from a few CKs with the intent to merge them together 
(if reconstructed CKs from different sources have too much 
overlap to simply “cat” them together) 


¢ A note stating which subset was extracted is put into the 
comment area of the output CK file 
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CKSLICER Example 


Navigation and Ancillary Information Facility 


Terminal Window 


$ dir mgs_sc_abl_v2.bc 
-rw-rw-r-- lotiaituser 195ss3a872 Jul 17 2980 mos se abl vesbe 


$ ckslicer -lsk naif0007.tls -sclk MGS SCLKSCET.00054.tsc -inputck 
mgs_sc_abl_ v2.bc -outputck mgs_sc_abl_970915.bc -id -94000 -timetype utc -start 
1997-SEP-15 18:00 -stop 1997-SEP-15 21:00 


CKSLICER: Version 1.0.1 July 17, 1999; Toolkit Version NQ057 


$ dir mgs_sc_abl_970915.be 
-rw-rw-rw- 1 naifuser a80296 Apr 25 10:23 mgs sc abl. S70915.0¢ 


$ ckbrief mgs_sc_abl_970915.bc naif0007.tls MGS SCLKSCET.00054.tsc -utc 


CKBRIEF Version: 2.0.0, 2001-05-16. SPICE Toolkit Version: NOQO57. 


Summary for: mgs sc abl 970915.be¢ 


Object: -94000 
Interval Begin UTC Interval End UTC 
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CKSPANIT 


Navigation and Ancillary Information Facility 


¢ ckspanit is a command line program for modifying interpolation 
interval information in type 3 CK segments 


— It can also convert a type 1 CK to a type 2 or 3 CK 


¢ ckspanit is used when one is dealing with a type 3 CK containing 
many small gaps within segments. It allows you to alter the CK in 
such a way that SPICE will interpolate over those gaps 


¢ ckspanit has the following usage 
ckspanit -in inp ck -out out_ck -tol threshold [-frm fk] 


— “Threshold” is the longest time interval over which interpolation is to be 
permitted in the output CK file 


» Must be specified in SCLK ticks 


¢ For example if 1 tick is 1/256 of a second and interpolation over 30 second intervals is 
needed, “threshold” must be set to 256*30=7680 


— “fk” is an optional FK file name, needed only if the base frame in the input CK 
is not one of the frames built into the Toolkit 
¢ See also the description of cksmrg 


CAUTION: before running ckspanit, make sure that interpolation over larger 
gaps is appropriate for the vehicle or structure you are dealing with. And 
don’t forget to add appropriate comments to the newly created CK file. 
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Navigation and Ancillary Information Facility 


CKSPANIT Example 


Terminal Window 


$ ckbrief m01_sc_2004-04-22.bc naif0007.tls ORB1 SCLKSCET.00078.tsc -utc -dump 
20.0, 2001-05-16. SPICE Toolkit Version: 
Summary for: m01 sc _ 2004-04-22.bc 


CKBRIEF Version: 


Segment No.: 1 
Object: -53000 


2004-APR-22 00 
2004-APR-22 18 
2004-APR-22 21 


CKBRIEF Version: 


Segment No.: 1 
Object: -53000 


terval Begin UTC 


:00:05.455 
2:55:05.054 
251:34.974 


20 
20 
20 


terval End UTC 


O4-APR-22 18:53:29.054 Y 
O4-APR-22 21:44:22.979 Y 


O4-APR-22 23:59:58.919 Y 


2.0.0, 2001-05-16. SPICE Toolkit Version: 
Summary for: m01 sc 2004-04-22 sp.bc 


Interval Begin UTC 


Non-Toolkit Applications 


Interval End UTC 


NOO57. 


ckspanit -in m01_sc_2004-04-22.bec -out m01_sc_ 2004-04-22 sp.be -tol 153600 


$ ckbrief m01_sc_2004-04-22 sp.be naif0007.tls ORB1 SCLKSCET.00078.tsc -utc -dump 


NOO57. 


CKSMRG 


Navigation and Ancillary Information Facility 


¢ cksmrg is acommand line program that merges data from Type 3 
CK ca provided in a single CK file, having the same ID and 
base frame 


¢ cksmrg is used for eliminating gaps between segments (that 
cannot be removed by ckspanit) and removing duplicate data 
points contained in different segments 


¢ cksmrg has the following usage 


cksmrg -k|-kernels <meta kernel name|kernel file names> 
-1i|-input <input ck file name> 
-o|-output <output ck file name> 
-s|-segid <output ck segment id string> 
-£|-fileid <output ck file id string> 
-b|-body <body id|name> 
-r|-reference <reference id|name> 
-a|-av <drop|keep|make|makeavrg> 
-t|-tolerance <tolerance (number units) > 
[-c|-correction <time delta|cor. table file>] 


CAUTION: cksmrg should not be used to merge CK segments from 
different sources (e.g. predicted and reconstructed), nor should it 
be used to merge overlapping predict CK segments 
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CKSMRG Example 


Navigation and Ancillary Information Facility 


Terminal Window 
S eckbrief m0O1.bc naif0007.tls ORB1_SCLKSCET.00078.tsc -utc -rel 


Object: -53000 
Interval Begin UTC Interval End UTC Relative to FRAME 


2004-APR-20 00:00:03.622 2004-APR-20 23:59:56.288 Y 
2004-APR-21 00:00:02.288 2004-APR-21 23:59:59.455 Y 


$ cksmrg -k naif0007.tls ORB1_ SCLKSCET.00078.tsc -i m01.bc -o m0l1s.be -s 
"CKSMRGed' -£ 'CKSMRGed' -b -53000 -r 'MARSIAU' -a keep -t 60 seconds 


(cksmrg displays quite a lot of diagnostics and progress information) 


S eckbrief mOls.bc naif0007.tls ORB1_ SCLKSCET.00078.tsc -utc -rel 


Object: -53000 
Interval Begin UTC Interval End UTC AV Relative to FRAME 
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MAKCLK 


Navigation and Ancillary Information Facility 


¢ makclk is a program for converting a SCLKSCET file to an SCLK kernel 


— SCLKSCET (a.k.a. SCLKvSCET) is a time correlation file used by most JPL 
missions 


— It is an ASCII text file providing piece-wise linear clock correlation function as 
an array of triplets consisting of the reference on-board time, the reference 
UTC time, and the clock rate 


— NAIF found that in many cases it is much easier to write an application to first 
make a SCLKSCET file and then convert it to an SCLK kernel using makclk 
than to write an application to make an SCLK kernel from “scratch” 


¢ makclk is an interactive program prompting for a single input - the name 
of the setup file 


¢ The setup file uses KEYWORD=VALUE assignments to specify input files 
(SCLKSCET, template SCLK, and LSK), output files (SCLK kernel and 
log), and control parameters (spacecraft ID, partition tolerance, time 
filtering flag, and rate adjustment flag) 


¢ The makclk User’s Guide provides detailed information about the setup 
file parameters and the SCLKSCET file format and contents. 
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MAKCLK Example 


Navigation and Ancillary Information Facility 


S$ more makclk.setup 
SCLKSCET FILE 

OLD SCLK KERNEL 
FILE NAME 
NAIF SPACECRAFT ID 
LEAPSECONDS FILE 
PARTITION TOLERANCE 
LOG FILE 


* __ SCLKO 


Lae ee 


if ome se! 
-77 

= naifoood 
10 
ELC eCl 


S more flc_ sclkscet.00007 
(... SCLKSCET SFDU header ...) 
CCSD3RE00000SSscetS$SNJIPL31S00613SS$datass 


SCETO 


0. 
189345665. 
189345666. 

268620868. 
276588129. 
281552200. 
284040077. 
284040078. 
287261113. 
291848718. 
CCSD3RE00000 


oOo. oe Oc Oo GO oO Oo CO 


Cr) 
U 
r) 
U 
r) 
U 
r) 
U 
r) 
U 
r) 
U 
Cr) 
U 
r) 
U 
r) 
U 
r) 
U 


wn Oo oOo 0 OC CO OC OC OC OC O 
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O-OO0O1T1I1:5 
6-OQO01TOO: 
6-OO01TOO: 
8-188T] 


Terminal Window 


kscet 


ie template 


kscet 


9.tls 


kscet 


-00007 
.tsc 
-00007.tsc 


.00007.log 


SCLKRATE 


OK 
200. 
200. 
t23¢ 


MB NM NN NY NN DN NH 


2 


la 
U 
r) 
U 
r) 
U 
r) 
U 
la 
U 
la 
U 
r) 
U 
r) 
U 
r) 
U 
r) 


U 


2 OC OO OO Or GC Oo OS 


C 


dataSSCCSD3RE0 


8-280T1 
8-338T 
9-OQ01T 
9-OQO01T 
9-038T 
9-O91T 


OS % 
223 
200. 
200. 
372954 
4:01. 
SSscl 


oOo oO OO WW OO O © 


.270 


314 


341 
342 


535 


136 


k$$ 


.000000000 
.000010000 
.000000000 
- 999998631 
. 999999788 
.000000029 
.000010000 
.000000029 
.000000131 
.000000166 


MAKCLK Example (continued) 


Navigation and Ancillary Information Facility 


Terminal Window 


$ more flc_template.tsc 
KPL/SCLK 
\begindata 
SCLK KERNEL ID @2009-04-07/12:00 
SCLK DATA TYPE 77 
SCLKO1 TIME SYSTEM 77 
SCLKO1_N FIELDS 77 
SCLKO1 MODULI _77 4294967296 256 ) 
SCLKO1_ OFFSETS 77 00 ) 
SCLKO1_ OUTPUT _DELIM_77 1 ) 
SCLK_ PARTITION START 77 .0000000000000E1 
SCLK PARTITION END 77 12 099S 116277 S0EFLA 
SCLKO1_ COEFFICIENTS 77 -E+00 0.E+00 1.54 
\begintext 


S makclk 


Enter the name of the command file 


> £1c_sclkscet.00007.setup 


fic sclkece..0G00) 6c created. 
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ORBNUM 


Navigation and Ancillary Information Facility 


¢ orbnum is a program for generating a SPICE orbit number file containing 
orbit numbers and corresponding orbit start/stop times, along with some 
additional derived quantities (orbital elements and coordinates of sub- 
spacecraft and sub-solar points) 


— The orbit number increment can be specified as occurring at one of these events: 
periapsis or apoapsis, ascending or descending equatorial node crossing, min or max 
value for the s/c position’s Z-coordinate, or min or max value of the s/c’s latitude 


¢ orbnum is a command line program with the following usage 
orbnum -pref pref file -num init orbit -file orbnum_file -d -v -audit -tdb -verbose 


optional 
— “pref_file” is a preferences file using text kernel syntax, specifying setup parameters 
along with the kernels containing data to be used to search for orbit start and stop events, 
spacecraft trajectory SPKs, center body PCK, spacecraft SCLK, etc. 


— “init_orbit” is the number to be assigned to the first orbit determined using the kernels 
provided; subsequent orbits are assigned by incrementing “init_orbit” by 1 


— “orbnum_file” is the name of the orbit number file to be created 


¢ An orbnum file is not considered a SPICE kernel 


— It’s just a convenient, derived product that NAIF offers to make for orbital missions that 


wish to have it 
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ORBNUM Example 


Navigation and Ancillary Information Facility 


Terminal Window 


$ more mex _orbnum.setup 

\begindata 

TARGET -4l 
OBSERVER 499 
EVENT DETECTION FRAME = 'MARSTAU’ 
EVENT DETECTION KEY 'PERI’ 
ELEMENTS INERTIAL FRAME "MARSTAU' 

ABERRATION CORRECTION = 'NONE' 

ORBIT PARAMS ( 'Sub Sol Lon', 'Sub Sol Lat', .. ) 

TEXT KERNELS = ( “de-245-masses.tpc’;, ~NALFOOU7 TLS", “tex U30722. Step.tsc’, 
BIN KERNELS = ( 'ORMF PSTPIX DB 00001.bsp', *‘DE4055.BSP’ ) 

SAFETY MARGIN = 0.5 

STEP SIZE TDB "DEFAULT! 

\begintext 


$ orbnum -pref mex _orbnum.setup -num 1 -file mex_orbnum.orb 


....Loading Kernels 


Start UTC (RET for default 2004 JAN 13 15:54:19.8) :<RETURN> 
End UTC (RET for default = 2004 AUG 05 02:10:24.8) :<RETURN> 


lv Working, please wait. 
mel §=Program Finished! 
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OPTIKS 


Navigation and Ancillary Information Facility 


optiks is a command line program that generates information about 
ee fields of view (FOV) from parameters present in IK and 
iles 


— FOVs must be defined using the keywords required by the GETFOV routine 
optiks is used in one of two ways 


optiks [options]... kernel ... 


optiks [options]... meta-kernel ... 


optiks uses a set of SPICE kernels specified on the command line; 
one or more of these kernels may be a meta-kernel 


The output data are organized in three tables 


— The first table lists the angular extents (size) of circular, elliptical, and 
rectangular FOVs. Using command line options “-units” and “-half” the user can 
select the unit of measure for the angular measurements, and whether half or 
full FOV angular extents are listed. 


— The second table contains FOV boresights in a user specified frame at a 
particular epoch, specified using the “-epoch” option 
— The third table shows FOV boundary vectors and boresights as returned from 


the GETFOV API, or unitized and rotated into a user-specified frame at a 
particular epoch 
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OPTIKS Example 


Navigation and Ancillary Information Facility 


Terminal Window 


$ optiks -frame CASSINI_SC_COORD cas iss v09.ti cas v37.tf naif0007.tls 
cas00084.tsc 


Kernels 


FOV ful 


Loaded: 


_ISS_NAC_RAD 


_ISS_WAC 


CASSINI_ 


ISS WAC RAD 


FOV boresights compu 


l-angular extents computed in RADIANS 


Length 


RECTANGULAR -006108652382 
CIRCULAR ~ 141592653590 
RECTANGULAR -060737457969 
CIRCULAR ~ 141592653590 


ted at epoch 2001-JAN-01 12:00 


FOV boresights comput 


Field of View 


INI_I 


SS_WAC 


CASSINI 


_ISS_WAC_RAD 
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ted in frame CASSINI_ SC COORD 


Boresight Vector 


575958621, - 999999819520, 
000000000, -000000000000, 
.0012183442306, ~999999225446, 
1.000000000000, -000000000000, 


Width 
-006108652382 
~ 141592653590 
-060737457969 
~ 141592653590 


-000170972424 
- 000000000000 
-000254451360 
- 000000000000 


ARCHTYPE 


Navigation and Ancillary Information Facility 


¢ archtype is a program that displays the file architecture and type 
of a SPICE kernel; it is useful for scripting applications 


— To identify the architecture and type archtype uses the same mechanism as 
the FURNSH routine 


¢ archtype has a simple command line interface and requires only 
one argument -- the name of a kernel file: 


archtype kernel name 


¢ archtype prints architecture and type to standard output as two 
space delimited acronyms 


— Architecture can be: 
» ‘DAF’ or ‘DAS’ for binary kernels 
» “KPL’ for text kernels 
— Type can be ‘SPK’, ‘PCK’, ‘IK’, ‘CK’, ‘EK’, ‘LSK’, ‘SCLK’, ‘FK’, ‘MK’, ‘DSK’ 
¢ If architecture and/or type cannot be determined, the program 
displays ‘UNK’ 
¢ In order for text kernels to be recognized, the first few characters 
of the file must contain ‘KPL/<type>’ (i.e. ‘KPL/IK’, ‘KPL/FK’, etc.) 
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ARCHTYPE Examples 


Navigation and Ancillary Information Facility 


Terminal Window 


$ archtype 020514 SE _SAT105.bsp 


DAF SPK 


$ archtype 04135 04171pc _psiv2.be 


DAF CK 


KPL SCLK 


KPL FK 


S archtype cas00084.tsc 


$ archtype cas _v37.tf 


S archtype cpck05Mar2004.tpc 
KPL PCK 


S archtype naif0008.tls 


KPL LSK 


S archtype .cshrec 
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NAIEs Navigation and Ancillary Information Facility 


¢ bffis a program that displays the binary file format of one or a few 
SPICE kernels 


¢ bffhas a simple command line interface requiring kernel names to 
be listed on the command line: 


bff kernel _name [kernel _ name ...] 


¢ bff prints the binary file format string (‘BIG-IEEE’ or ‘LTL-IEEE’) to 
standard output 
— When run on a single kernel, it prints only the format string 


— When run on more than one kernel, it prints the format string followed by the 
file name on a separate line for each file 


¢ If an input file is not a binary kernel, the program displays the 
format string ‘N/A’ 


¢ If the binary file format cannot be determined (for DAS files 
produced by applications linked to SPICE Toolkit N0051, April 
2000 or earlier), the program displays the format string ‘UNK’ 
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BFF Examples 


Navigation and Ancillary Information Facility 


Terminal Window 


S bff mer2_surf rover.bsp 
BIG-IEEE 


S bff ./*.be ./*.bsp ./*.tf£ ./*.xsp 

IG-IEEE ./MRO PHX EDL 07260 PASS1 sc_20070917181502.be 
./070416BP_IRRE 00256 14363.bsp 

./mars north.bsp 


./mer2 surf rover.bsp 
./sb406-20pb.bsp 
(ZeEo Orfiset. bsp 

ef POeee 


./mgn06127.xsp 
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BINGO 


Navigation and Ancillary Information Facility 


¢ bingo is a program that converts: 
— binary SPICE kernels between IEEE big endian and little endian formats 
— text format SPICE kernels between DOS and UNIX text formats 

¢ bingo has a simple command line interface: 
bingo [option] input_kernel output_kernel 


— “option” is a flag specifying the conversion direction: ‘-ieee2pc’ or ‘-pc2ieee’ for binary 
kernels and ‘-unix2dos’ or ‘-dos2unix’ for text format kernels 


— “input_kernel” is the input kernel file name 


— “output_kernel” is the output kernel file name. If the output file already exists, the 
program overwrites it. 


¢ The conversion direction flag does not need to be specified for 
DAF -based binary file conversions (SPK, CK, binary PCK) and 
post-N0051 DAS-based binary file conversions (EK, DBK, DSK) 


— The program automatically determines the input file format and performs conversion to 
the other format 


¢ The conversion direction flag must be specified for pre-N0051 
DAS-based binary file conversions, and for text file conversions 
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BINGO Examples 


Navigation and Ancillary Information Facility 


Terminal Window 


DAF-based binary kernel conversions: 

$ bingo de405s_ieee.bsp de405s_ pc.bsp 

S bingo de405s_pc.bsp de405s ieee.bsp 
Modern DAS-based binary kernel conversions: 
$ bingo 10A_ieee.bdb 10A_pc.bdb 

$ bingo 10A_pc.bdb 10A_ieee.bdb 


Text kernel conversions: 


$ bingo -unix2dos naif0008 unix.tls naif0008 dos.tls 


$ bingo -dos2unix naif0008 dos.tls naif0008 unix.tls 


Non-Toolkit Applications 


